Three platform-aware response improvements landing without new
dependencies, all gated on meta.interfaces.screen so voice-only
surfaces (Mini, Pro) are unaffected:

- card parameter plumbed through _yandex_response (BigImage / ItemsList /
  ImageGallery shapes documented). Actual emission deferred to Phase 1.5
  — BigImage requires image_id of a pre-uploaded asset and per-track
  album art can't be uploaded inside the 3-second webhook budget.

- Suggestion buttons (Следующая / Пауза / Громче / Тише) appended to
  play- and control-success responses on screened surfaces. Lets the
  user follow up by tap without re-saying the activation phrase.

- TTS dictionary moved to provider/tts_dictionary.py with two tables:
  WORD_REPLACEMENTS (Russian stress hints + ~26 foreign single-word
  artist transliterations) and PHRASE_REPLACEMENTS (16 multi-word
  bands, applied before the per-word regex). _tts_for now matches both
  Latin and Cyrillic so "Включаю Metallica" emits tts="Включ+аю
  Мет+аллика". text stays clean.

- voice_continuation toggle (CONF_DIALOG_VOICE_CONTINUATION, default
  off): when enabled, play- and control-success keep end_session=False
  for natural follow-ups. "стоп / выключи / выключи музыку" always
  closes the session regardless of the toggle. No UI surface yet —
  power-user knob for now.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

…t.nlu.intents (Phase 2)

Delegates intent classification to Yandex's grammar engine for the closed
set of control commands and the my_wave play intent. The platform's
synchronously-classified `request.nlu.intents.<form_name>` block now takes
precedence in the webhook handler; the existing regex parsers
(parse_command / parse_control) remain as fallback for phrases that
don't match any declared grammar — so this is purely additive coverage,
no regression risk.

Eleven grammars ship in provider/dialogs_grammar.py:
  control.{pause,resume,next,previous,stop,volume_up,volume_down,
           shuffle_on,shuffle_off,now_playing}
  play.my_wave

Each carries `positiveTests` for the dev-console "Протестировать" button
and uses %lemma where multi-word morphology matters. All grammar bodies
are conservative — Yandex's server-side validator catches malformed
sources synchronously and surfaces them as DialogsIntentValidationError,
so set_intents() will fail loud rather than silently deploying broken
NLU.

The intents pipeline runs between draft update and request_deploy, so
they land in the same moderation cycle as the rest of the draft (no
two-phase publish needed). Endpoints + payload shape were derived from
a Playwright probe of the live dev console on 2026-05-07; the
ya-dialogs-api>=2.1.0 dependency wraps the five new REST endpoints.

Bumps ya-dialogs-api>=2.1.0 in pyproject.toml + manifest.json.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Yandex automatically classifies four built-in intents (CONFIRM / REJECT /
HELP / REPEAT) once any custom grammar is declared on the skill — and we
declared eleven in the previous Phase 2 commit. This wires up the two
that have unambiguous behaviour in our flows:

- YANDEX.REJECT during a pending disambiguation prompt or slot-elicit
  ("На какой колонке?" / "Что включить?") → respond "Хорошо, отменил.",
  clear pending state, end session. Outside of those prompts the intent
  falls through to normal command parsing — "отмена" without context is
  not a free-standing app-cancel signal.
- YANDEX.HELP → contextual hint matching the current prompt: re-explain
  how to answer the disambiguation, suggest example queries during slot
  elicit, or surface a generic "включи рок на кухне" example otherwise.
  State is preserved so the user can answer the original question next.

CONFIRM and REPEAT are deferred:
- CONFIRM is ambiguous in our flows (which player is the user agreeing
  to? — we have no canonical "yes" target).
- REPEAT requires caching the last response on session_state.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Upstream Music Assistant CLAUDE.md mandates Sphinx-style docstrings
(`:param:` syntax) and explicitly bans Google-style (`Args:`) and
bullet-style (`- param:`) — flagged in PR #3843 review by @chrisuthe.

This commit:

1. Adds a CLAUDE.md at the repo root that mirrors upstream's relevant
   sections (Behaviour, Code Style, Branching) and adapts the rest to
   this provider repo's specifics (sync workflow, provider/ layout,
   pre-commit gate, debugging via $HOME/.musicassistant). Cross-refs
   the Copilot review findings (is_public_https_url for any new
   network input) so future contributors don't re-introduce the same
   bug.

2. Converts the six Google-style docstring sections that had crept in
   (auth_page.py, auth_session.py, dialog_skill_meta.py, dialogs.py,
   dialogs_control.py, dialogs_nlu.py) to Sphinx-style. No behaviour
   change.

The webhook-handler error-handling concern from the same review thread
is mentioned in CLAUDE.md as a known follow-up but not addressed here —
that's a separate code change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Per @chrisuthe's review of upstream PR #3843: only `request.json()` was
guarded; an unexpected raise from a parser, the resolver, or MA dispatch
bubbled to aiohttp → HTTP 500 → Alice silence on the user's device.

Refactors `_handle_webhook` so the post-auth body lives in a new
`_handle_authenticated_request` method, called inside a `try / except`
that catches any non-CancelledError exception, logs it, and returns a
generic Russian fallback ("Что-то пошло не так. Попробуй ещё раз.")
with `end_session=False` so the conversation can continue. The original
exception is still emitted via `_logger.exception` so operators can
debug from `$HOME/.musicassistant/musicassistant.log`.

Adds a regression test that injects a RuntimeError into
`mass.players.all_players` (deep inside the play-resolve path) and
verifies the response is HTTP 200 with the Russian fallback text and
`end_session=false` — not HTTP 500.

CLAUDE.md updated to call out the contract so future branches don't
regress it.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>